Skip to content

docs: record the San Acacia piezometer identifier conflicts - #855

Merged
jirhiker merged 1 commit into
stagingfrom
docs/piezometer-identifier-conflicts
Aug 19, 2026
Merged

docs: record the San Acacia piezometer identifier conflicts#855
jirhiker merged 1 commit into
stagingfrom
docs/piezometer-identifier-conflicts

Conversation

@jirhiker

Copy link
Copy Markdown
Member

Write-up backing BDMS-1168. Found while reconciling Diver-HUB monitoring
points against Ocotillo wells; present in production, not only staging.

Three distinct problems, none of which block ingestion — the vendor names its
points SO-#### and Ocotillo agrees on those, so matching is exact. They matter
to anyone who identifies these wells by field name instead.

  1. The NMBGMR and unattributed identifier sources assign A and B to opposite
    wells
    for the BRN-E04 shallow/deep pair. A swap on a piezometer nest
    attributes a shallow series to a deep well.
  2. They disagree on whether SO-0262/SO-0263 are NRCS site 3 or site 2
    and site 2 already exists as SO-0274 with its own piezometers.
  3. The A/B suffix does not consistently mean depth. A is the deep well at
    four sites and the shallow one at two, inconsistently even within the NRCS
    series. Any analysis assuming "A is deep" is right four times and wrong twice.

How it was found

Matching on alternate_id produced a confident single hit for BRN-E04A on
SO-0131 — contradicting NMBGMR — with no ambiguity flag, because the
(shallow) suffix makes the two strings differ. A wrong answer with no sign of
trouble, which is worse than the ambiguity the reconciler was built to escalate.

External-id matching is opt-in as a result, with a test pinning these rows
(merged in #852). That is a guard, not a fix: the records still disagree.

Sibling of BDMS-1169 (394,086 observations with no AMPAPI QC provenance), found
in the same work.

🤖 Generated with Claude Code

Found while reconciling Diver-HUB points against Ocotillo wells. Present in
production, not only staging.

Three separate problems. The NMBGMR and unattributed identifier sources assign A
and B to opposite wells for the BRN-E04 shallow/deep pair. They disagree about
whether SO-0262/SO-0263 belong to NRCS site 3 or site 2, where site 2 already
exists as SO-0274 and its piezometers. And the A/B suffix does not consistently
indicate depth -- A is the deep well at four sites and the shallow one at two,
inconsistently even within the NRCS series.

None of it blocks ingestion, which matches on SO-#### where both systems agree.
It matters to anyone identifying these wells by field name, and a swap on a
paired piezometer nest attributes a shallow series to a deep well.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@github-actions

Copy link
Copy Markdown
Contributor

Coverage

79.33% total — gate is 75%.

@jirhiker
jirhiker merged commit 6bf1b00 into staging Aug 19, 2026
9 checks passed
@jirhiker
jirhiker deleted the docs/piezometer-identifier-conflicts branch August 19, 2026 17:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant